home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_313 / uucp / uucp1.lzh / man / Getty < prev    next >
Text File  |  1989-10-27  |  6KB  |  182 lines
  1.  
  2. NAME
  3.     Getty
  4.  
  5. SYNOPSIS
  6.     Getty -Sserialname -Uunit -Bbaud -Bbaud.. -Mc
  7.           -m1 -r0 -h0 -c0 -xn -A -7 -0 [modem-cmds]
  8.  
  9.     NOTE BUG:  You currently cannot run more than one Getty per
  10.     *DEVICE NAME*, i.e. on more than one unit per device.
  11.  
  12. DESCRIPTION
  13.     Getty hangs on the specified serial port (serial.device unit 0 by
  14.     default) waiting for connections via the connected modem.  Once
  15.     a connection is accepted Getty adjusts to the proper baud rate
  16.     using the CONNECT message, -B, -A options, then provides a
  17.     Login: request to the caller.
  18.  
  19.     NOTE: A CONNECT message from the modem with no baud rate specified
  20.     will cause Getty to use the first baud rate in the -B list.  If
  21.     the -A option is specified, Getty *always* uses the first baud
  22.     rate in the -B list and never switches to any other baud rate.
  23.  
  24.     If the caller sends a line-break Getty will switch to the next
  25.     baud rate in the specified list.  During the initialization phase
  26.     of the modem (before the first call and after a disconnect), Getty
  27.     readjusts the baud rate to the first specified rate.
  28.  
  29.     Getty disconnects any caller who cannot provide a legal Login and
  30.     Password within 60 seconds.
  31.  
  32.     Upon receiving a legal Login and and Password, verified via
  33.     GETTY:PASSWD, Getty will execute the program specified in
  34.     GETTY:PASSWD, usually UUCICO, and stay off the line until
  35.     UUCICO returns.  When UUCICO returns, Getty will disconnect
  36.     the caller and reset the modem, returning to its original state.
  37.  
  38.     The file GETTY:Getty-Header contains a couple lines of text
  39.     that are sent over the serial port before the Login: request.
  40.     In it you normally have your machine type, name, etc...
  41.  
  42.     Getty runs the specified program in the password entry adding
  43.     the following arguments:
  44.  
  45.         -Getty -DEVICE devicename -UNIT unitnumber
  46.  
  47.     (uucico will recognize said arguments and not attempt to
  48.      initialize / waitfor calls / hangup the modem itself)
  49.  
  50.     Getty also recognizes when other amiga programs open the
  51.     serial.device it is waiting on and will get off the line for
  52.     the duration of the other program's connect (i.e. you can run
  53.     terminal programs without having to BREAK Getty).
  54.  
  55.     NOTE 1:     Getty can only get off the line when it is idle,
  56.             waiting for carrier.  UUCP related programs will
  57.             also use a separate locking mechanism to properly
  58.             talk to Getty under other circumstances.
  59.  
  60.     NOTE 2:     Getty will attempt a disconnect sequence when it
  61.             reestablishes control after the other program
  62.             closes the serial.device .    Getty checks the
  63.             device count once a second.
  64.  
  65. OPTIONS
  66.     -Sserialname        Specify serial device, default "serial.device"
  67.  
  68.     -Uunit            Specify unit number, default 0
  69.  
  70.     -Bbaud            Specify up to 32 baud rates
  71.  
  72.     -A            Specify modem will adjust to a single baud
  73.                 rate (locks the serial.device at the first
  74.                 baud rate in the -B list)
  75.  
  76.     -7            Use SERF_7WIRE protocol while online,
  77.                 else uses no protocol while online.  If
  78.                 you are using a modem with speed conversion
  79.                 you need this option or you will most likely
  80.                 overflow the modem's buffer!
  81.  
  82.     -Mc            Select Modem type,
  83.  
  84.                 c = m   Multimodem
  85.                 h   Hays
  86.                 d   Dumb  (no AT or +++ commands are
  87.                        sent to the modem ever).
  88.  
  89.     -mn            Set modem speaker level, default 0.
  90.                 (ATMn command)
  91.  
  92.     -rn            Set modem to answer on the Nth ring
  93.                 (modem must support ATMn).  0 disables
  94.                 answer capability.    The default is to
  95.                 answer on the second ring.
  96.  
  97.     -h0            Ignore CD (carrier detect).  If this option
  98.                 is specified a continuous carrier detect is
  99.                 assumed, causing Getty to request Login:'s
  100.                 over the line as soon as it receives a CONNECT
  101.                 message.
  102.  
  103.                 It is suggested you ONLY use this option
  104.                 when combined with -c0
  105.  
  106.     -c0            Do NOT look for a CONNECT message from the
  107.                 modem... useful for dumb modems.
  108.  
  109.     -d0            Normally Getty will disconnect by dropping
  110.                 DTR.  If this option is specified, Getty will
  111.                 use the less reliable +++ ATH0 sequence.
  112.  
  113.     -xn            Set debugging level to n.  If specified
  114.                 debugging messages are sent to stdout instead
  115.                 of GETTY:LOGFILE
  116.  
  117.                 Note: to avoid GETTY:LOGFILE getting too
  118.                 large for busy systems, you can always add
  119.                 an entry to your crontab to delete it once
  120.                 a week (or whenever).
  121.  
  122.     -0            Kill any already-running Getty for this
  123.                 serial port and unit.
  124.  
  125.     modem-cmds        You may specify up to 16 specific commands
  126.                 to be sent to the modem whenever it is
  127.                 initialized (usually after a disconnect
  128.                 and on startup).  Each command will be
  129.                 sent to the modem with a CR on the end and
  130.                 a seconds delay afterwords.  Example:
  131.  
  132.                 ATS2=.
  133.  
  134.                 This is useful for provided specialized
  135.                 modems with the appropriate initialization
  136.                 strings.
  137.  
  138. EXAMPLE
  139.     ;   Run a Getty for a MultiModem
  140.  
  141.     run >nil: <nil: Getty -Mm -A -B19200
  142.  
  143.     ;   Run a Getty for a Hays Modem
  144.  
  145.     run >nil: <nil: Getty -Mh -B1200 -B2400
  146.  
  147.     ;   Modify options to a Getty already running in the background
  148.  
  149.     Getty -m1        ; Set speaker on during dialing
  150.     Getty -m0        ; speaker off at all times.
  151.     Getty -0        ; kill background Getty
  152.  
  153. EXAMPLE CRONTAB ENTRIES
  154.     Assuming a getty has been run in the background from your
  155.     startup sequence, the most common desire is to disable the
  156.     modem speaker while you are asleep, and enable it at other
  157.     times.    The following crontab entry will accomplish this:
  158.  
  159. 0    23    *    *    *    getty -m0
  160. 0    11    *    *    *    getty -m1
  161.  
  162.     You can also kill (getty -0) or restart getty from your
  163.     crontab, though the prefered method is to leave it running
  164.     and only disable/enable the autoanswer (-r option) for those
  165.     times you wish your modem to not accept calls.
  166.  
  167.  
  168. FILES/REQUIRES
  169.     GETTY:PASSWD
  170.     GETTY:Getty-Header
  171.     GETTY:LOGFILE
  172.  
  173.     The NULL: handler must be mounted
  174.     The UUSER: handler must be mounted if Passwd file contains
  175.         *'d executable entries (don't confuse *'d executables
  176.         with using '*' for the password field).
  177.  
  178. REFERENCES
  179.     Getty
  180.     Passwd
  181.  
  182.